home *** CD-ROM | disk | FTP | other *** search
/ MacFormat 1995 June / MacFormat 25.iso / Shareware City / Games / marathon-net-edit-11 / NetEdit / NetEdit ReadMe next >
Encoding:
Text File  |  1995-02-20  |  8.4 KB  |  192 lines  |  [TEXT/R*ch]
  1. Net Edit v1.1 (aka Object Placement Editor v1.1)
  2.  
  3. By Eric Bennett (ericb@psu.edu)
  4.  
  5. ==============================================================================
  6. General
  7. ==============================================================================
  8.  
  9. Have you played Marathon over the network enough times that you're sick
  10. of seeing the same aliens repeatedly?  This program allows you to change:
  11.  
  12. -how many aliens/objects of each type are initially present on a level
  13. -how many aliens/objects of each type are present during play
  14. -how frequently the number of aliens/objects is replenished to the full amount
  15. -whether aliens/objects are placed randomly or in specific locations
  16.  
  17. Although these changes are primarily useful for modifying net play, you can
  18. also use this program as a cheater in the regular game by adding objects
  19. or removing aliens.
  20.  
  21. ==============================================================================
  22. License and (lack of) Warranty
  23. ==============================================================================
  24.  
  25. This program is freeware.  You may redistribute this program provided that you
  26. included the original, unmodified application and readme files and NOTHING
  27. ELSE.  You may charge duplication fees for distributing this program, but your
  28. fee may not exceed the basic cost of media duplication (you may place this
  29. program on an online service as long as downloading the file incurs only
  30. standard connection charges).  Permission is specifically granted to the
  31. maintainers of the archives at Sumex-Aim.stanford.edu to include this program
  32. on the CD-ROM distribution of the archive.
  33.  
  34. DO NOT DISTRIBUTE NET EDIT TO THE FOLLOWING SITES:
  35. sumex-aim.stanford.edu
  36. ftp.amug.org
  37. America Online (Macintosh Games Forum)
  38.  
  39. I will update these three sites myself, so please don't send them extra copies.
  40.  
  41. The author (Eric Bennett) in no way warrants that the program will perform
  42. as described in this manual (or any other document).  USE THIS SOFTWARE
  43. AT YOUR OWN RISK!
  44.  
  45.  
  46. ==============================================================================
  47. How to get new versions
  48. ==============================================================================
  49.  
  50. I will post new versions to sumex-aim.stanford.edu, America Online (Mac Games
  51. Forum) and ftp.amug.org.  You can also get the program from my web page:
  52.  
  53. http://emb121.rh.psu.edu/marathon/marathon.html
  54.  
  55.  
  56. ==============================================================================
  57. Special Considerations--READ BEFORE USING!
  58. ==============================================================================
  59.  
  60. First, be sure that NetEdit has enough memory.  You need about 400k of memory
  61. to load the program, but you'll need more memory to load a map (the data
  62. you'll be editing is in the mpa file).  Add 400k to the size of the map file
  63. you'll be editing, and give NetEdit this amount of RAM using "Get Info" in the
  64. Finder.  For example, the map file that comes with the release version of
  65. Marathon is about 3700k, so give NetEdit 4100k. You should be able to use maps
  66. from the Demo or the commercial release. If the format of your map file is not
  67. the same, this program will probably corrupt it.
  68.  
  69. EDIT ONLY A BACKUP COPY OF YOUR MAP FILE.  This program is not based on solid
  70. information from Bungie; it uses information uncovered by Tom Klancer and
  71. myself.  Don't trust this program to work.
  72.  
  73. For net play, it is probably safer to have one person alter the map file and then give
  74. this file to each network player than to have each network player attempt
  75. to make the same alterations to his or her own copy of the map file.  If
  76. the changes are not exactly the same, the network game will be
  77. unsynchronized.
  78.  
  79.  
  80. ==============================================================================
  81. How to use NetEdit
  82. ==============================================================================
  83.  
  84. After loading NetEdit, select "Open..." from the file menu and load your map.
  85. NetEdit will scan the file for valid levels.
  86.  
  87. Now select the desired level under the "Levels" menu.  If a level does not
  88. currently contain certain byte values, NetEdit warns you that it will
  89. have to do some random guesswork in order to edit the level (if you get this
  90. message, proceed with the understanding that Marathon may crash when you use
  91. the edited map file).
  92.  
  93. You can select which character/object you wish to edit by selecting it from
  94. the "Characters" or "Objects" menus.  In the main window, there are four
  95. edit fields:
  96.  
  97. -Placement method
  98.         If you place a 1 here, objects will be placed randomly on the level.  
  99.     Net levels work in this way.  Regular game levels have a zero, meaning that
  100.     aliens are placed in specific places on the level.  Changing the default
  101.     value on a given level from 0 to 1 should not cause problems, but I don't
  102.     know how Marathon responds when directed to placed objects in specific
  103.     locations when they're usually random.
  104.         If you use a value other than 0 or 1, NetEdit uses a 1 because 1 is
  105.     guaranteed to work.
  106. -Initial # of object
  107.         The object will be placed this many times on the level before game
  108.     play begins; objects are placed depending on the value of the first field.
  109. -Replenishment frequency
  110.         How often Marathon replenishes the object/alien so that the total number
  111.     in the game is equal to the value in the next field.
  112. -Total # per level
  113.         This represents the total number of the alien or object that can be
  114.     present on the level at once.  For example, a value of 10 in the record
  115.     for napalm canisters means that at most 10 canisters can be in play (held
  116.     by players or sitting on the floor) at any one time.
  117.  
  118. An replenishment frequency of zero is the lowest frequency, but Marathon will
  119. still replenish occasionally (if you want none of a certain object/alien type,
  120. set the "Total # per level" to zero).
  121.  
  122. If you enter a value less than 0 or greater than 255 for the last three fields,
  123. NetEdit will use 0 instead.
  124.  
  125. To clear all characters or objects from the level, choose "Remove all aliens"
  126. or "Remove all objects" from the special menu. "Clear All Records" does both.
  127.  
  128. NetEdit does NOT ask whether you want to save changes before quitting or
  129. closing the current file, so be sure to SAVE FIRST!
  130.  
  131.  
  132. ==============================================================================
  133. About the Included Files (in the "File Formats" directory)
  134. ==============================================================================
  135.  
  136. "How NetEdit works"        describes what I know about the "plac" section.
  137. "Map Editing"            a somewhat dated file with info on the map file
  138.                             (I did _not_ write this file)
  139. "Marathon File Specs"    file format info for several of Marathon's files.
  140.                             (I did _not_ write this file)
  141.  
  142.  
  143. ==============================================================================
  144. Version History
  145. ==============================================================================
  146.  
  147. 02/21/95 -- version 1.1.
  148.             Added editing of objects (added the "Objects" menu).
  149.             Fixed possible crash when Opening a locked file (Save still bombs).
  150.             Fixed some typos in the manual.
  151.             Program is now 4987 bytes smaller.
  152.             Removed annoying startup window flash.
  153.             Included information on Marathon file formats.
  154.             Added "Placement Method" field.
  155.             Changed description of a field to reflect what it _really_ is.
  156.                 (changed "aliens per addition" to "total # object")
  157.             Removed the close box in the main window since you can't ever
  158.                 close it.
  159.             
  160. 02/11/95 -- version 1.0
  161.                First version of NetEdit.  Written in about 6 hours and possibly buggy :)
  162.      
  163.      
  164. Possible future enhancements:
  165.     - clean up the interface (make the TAB key work :)
  166.     - error handling (currently, NetEdit bombs on locked files etc.)         
  167.  
  168.  
  169. ==============================================================================
  170. HOW TO REPORT BUGS
  171. ==============================================================================
  172.  
  173. If you find a bug, please figure out how to reproduce it, then send me a bug
  174. report at any of the following email addresses:
  175.  
  176. Marathon@emb121.rh.psu.edu   (fastest response during fall/spring semester)
  177. EricB@psu.edu                (guaranteed to reach me any time of year)
  178. EricB888@aol.com             (I don't read this often)
  179. emb121@psuvm.psu.edu         (I almost *never* read this)
  180.  
  181.  
  182.  
  183. ==============================================================================
  184. Special Thanks
  185. ==============================================================================
  186.  
  187. Thanks go to:
  188.  
  189. -Tom Klancer     : provided some information on the map file format.
  190. -Bungie Software : created Marathon :).
  191. -Zedcor, Inc.    : published my S'pht, FutureBasic 1.0.3.
  192.